fix(agent-core-v2): fold UserPromptSubmit hook output into the prompt message - #4081

Requirement or Bug

Resolve #4032

Supersedes #4078（评审历史见该 PR）。

Bug Reproduction Steps

See linked issue（2.1.0/2.1.1 可复现：配置 UserPromptSubmit 钩子的会话里，轮次整体错位一位，最后一条消息看起来永远没有回复，刷新后恢复）。

Root Cause

引擎在 UserPromptSubmit 钩子返回文本后，把它作为一条独立的 user 角色消息（origin: hook_result）追加到真实用户消息之前，上下文序列变成 [hook 消息][用户消息][回复]，user 单元翻倍。渲染层的轮次配对依赖「一个 user 单元配一段 assistant 输出」的不变量，任何不消费 origin 的配对路径都会因多出的 user 单元而整体错位一位。排查确认数据层（wire、fold、live store、投影）完整且对齐，错位只来自不消费 hook origin 的渲染路径。

这是根本修复而非绕过：让「一条 prompt 一条 user 消息」在结构上成立——钩子注入文本以带 meta 标记的 content part 并入 user prompt 消息，不再产生第二条 user 消息，轮次配对在结构上不存在错位可能，不再依赖每条渲染路径自觉遵守 origin 约定。

Code Changes

三个提交，按主题分六块：

1. content part 增加 meta 能力（agent-core-v2 + transcript）

// packages/agent-core-v2/src/human/llm/message.ts
interface TextPart {
  type: 'text';
  text: string;
  meta?: { source?: string; contentType?: string };  // 新增,仅 text 类型
}

wire schema（historySchema.ts）以 z.record 形态接受 meta（通用字典，前向兼容）;packages/transcript 的 HistoryContentPart text 变体同步（browser-safe 纯类型）。meta 不下发 LLM provider（adapter 只读 type/text)。

2. 钩子注入合并进 prompt 消息（gate 单次落盘）

 runPromptGate
   onBeforeSubmitPrompt
-    hook 服务: context.append(独立 hook_result user 消息)   # user 单元翻倍
+    hook 服务: ctx.hookParts.push(meta 标记的 text part)
   组装最终消息
-    content = 原始 prompt
+    content = [...hook parts, ...原始 prompt]               # 一次 append 落盘

• PromptSubmitContext 增加 hookParts 可变插槽（钩子的唯一输出通道,与既有 block 字段同模式）;hook part 固定形状 { type:'text', text:'<hook_result …>…</hook_result>', meta:{ contentType:'text/xml', source:'user prompt submit hook' } }，多钩子按返回顺序各成一个 part。
• 附带修复：stdout 为 JSON 且无 message 字段（如 {"continue":true}）不再注入任何内容（此前原文注入，每轮都有噪声）；纯文本 stdout 仍兜底注入。

3. Turn 层记录保留完整数据（vis/replay 可见）

turn.prompt wire 记录含完整 hook 内容（持久化、进上下文）；TurnStarted 事件不落 wire，其 prompt 在构造点按 meta 剥离 hook part——公开客户端拿到干净文本，持久化与上下文语义不受影响。

4. 展示层可见渲染 / 干净摘要

• transcript 冷 fold：hook part 映射为 hook marker（载荷与 live hook.result marker 同形），轮 prompt 提取/steer 匹配仍按剥离后内容加工，不产生 0 步轮组；
• transcript live 投影：轮标题即 turn.started.prompt（构造点已按 meta 剥离，投影不做任何字符串加工，用户手敲相同 wrapper 开头原样保留）；
• TUI replay：meta hook part 渲染为与老 wire 相同的 hook 条目，prompt 文本干净；
• VS Code replay：TurnBegin.user_input 剥 hook part，hook 正文以 StepBegin 后的 ContentPart 可见渲染（webview reducer 要求 step 存在，否则丢弃）;
• TUI /export-md 与 VS Code /export 的 markdown、VS Code /import <session> 的会话文本：均剥 hook part，内部协议 XML 不再进入导出文件或被再注入其他会话；
• undo 后的 lastPrompt 重算（session 列表摘要）剥 hook part，与 title/fork 路径对齐；
• 存量 wire 的独立 hook 消息按原逻辑继续处理，两制并存。

5. skill bundled 块统一 meta 化，消除位置切片

skill 块与 hook part 一样在构造时携带 meta: { source: 'skill activation', activationId }（fallback 补标时按 origin 顺序对应一并回填 activationId，新老 wire 的 skill part 均自描述）。原先全部 content.slice(skillActivations.length) 位置切片点——轮 prompt 文本、steer 合并与 echo、会话标题与 fork 标题、transcript fold、TUI replay——统一改为「先 annotate 再按 meta 过滤」:annotate 是集中的向后兼容层，老 wire 里无标记的前 N 个块（每个 bundled activation 一个）在读取时补标，之后与有标记的新 wire 走同一条过滤路径。prompt 内容不再依赖块位置，loop 也无需识别 hook part。

Behavior Changes and Affected Users

受影响模块与测试覆盖（测试数净增为 0，均为扩展既有用例）：

• 合并与记录（agent-core-v2 gate / 钩子服务）：promptService.test.ts 的 gate 用例钉住单条 user 消息、content[0] meta 形状、turn.prompt 记录含 hook 内容、TurnStarted.prompt 构造点剥离为干净文本、skill 块不进 prompt 文本；
• 注入协议（runHook / userPrompt）：runner.test.ts 钉住无 message JSON（含 {"continue":true}）不注入、纯文本 stdout 产出带约定 meta 的 part；
• skill meta 与 fallback（origin.ts / steer 合并）：promptService.test.ts 的 steer/queue 用例与 machine.test.ts 钉住标记与未标记块两种形态的合并/echo 结果；
• transcript fold/steer 与 live 投影（transcript、kap-server）：layers.test.ts 钉住 hook marker 可见、bundled 两形态一致、steer content-key 匹配；transcript.test.ts 钉住轮标题 meta 级剥离；
• TUI replay 与 export（apps/kimi-code）：message-replay.test.ts、kimi-tui-message-flow.test.ts、export-markdown.test.ts 钉住 hook 条目可见、prompt/导出文本干净；
• VS Code replay/export/import（apps/vscode）：replay-adapter.test.ts 钉住 TurnBegin 干净、hook 经 StepBegin 后 ContentPart 可见；
• undo lastPrompt（agent-core-v2）：undo.test.ts 钉住锚点与 pending 两分支剥 hook part；
• 全量测试（m0-dev）：898 文件 / 16662 用例全部通过。

Checklist

• I have read the CONTRIBUTING document.
• I have linked a related issue (external PRs: issue must have a maintainer's /approve).
• I have added tests that prove my feature works.（按仓库规则净增为 0：扩展既有用例覆盖全部新行为）
• The behavior-change table above is complete, and every removed behavior or flipped default is named in the changeset and either has an escape hatch or was explicitly approved by a maintainer in this PR.（被移除的裸 JSON 注入行为及退路见上表；changeset 聚焦用户可感的错位修复）
• Ran gen-changesets skill, or this PR needs no changeset.
• Ran gen-docs skill, or this PR needs no doc update.（state-manifest.d.ts 已随类型同步重新生成）